Add an intro.

2004-11-01  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkcellrendererpixbuf.sgml: Add an intro.

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index f7c0f334551137d55eae19ca314f826638bd67b7..67a094e789028c8b63153bf6ae95d47c183d2f8e 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,7 @@
 2004-11-01  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/tmpl/gtkcellrendererpixbuf.sgml: Add an intro.
+
        * gtk/tmpl/gtkfilechooserbutton.sgml: Move some docs inline.
 
        * gtk/tmpl/gtkaboutdialog.sgml: Small update.

diff --git a/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml b/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml
index 575380df174ac004d77c2581b5cf5617447dc496..b574076f7035939a699fc2db8d6f4761e92e487d 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml
+++ b/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml
@@ -6,7 +6,21 @@ Renders a pixbuf in a cell
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+A #GtkCellRendererPixbuf can be used to render an image in a cell. It allows to render 
+either a given #GdkPixbuf (set via the <link linkend="GtkCellRendererPixbuf--pixbuf">pixbuf</link>
+property) or a stock icon (set via the <link linkend="GtkCellRendererPixbuf--stock-id">stock-id</link>
+property).
+</para>
 
+<para>
+To support the tree view, #GtkCellRendererPixbuf also supports rendering two alternative pixbufs,
+when the <link linkend="GtkCellRenderer--is-expander">is-expander</link> property is %TRUE.
+If the <link linkend="GtkCellRenderer--is-expander">is-expander</link> property is %TRUE and
+the <link linkend="GtkCellRendererPixbuf--pixbuf-expander-open">pixbuf-expander-open</link> property
+is set to a pixbuf, it renders that pixbuf, if the 
+<link linkend="GtkCellRenderer--is-expander">is-expander</link> property is %FALSE and
+the <link linkend="GtkCellRendererPixbuf--pixbuf-expander-closed">pixbuf-expander-closed</link> property
+is set to a pixbuf, it renders that one. 
 </para>
 
 <!-- ##### SECTION See_Also ##### -->